/*
 * Copyright 2018-9-30 20:11:44 The JA-SIG Collaborative. All rights reserved.
 * distributed with thi file and available online at
 */
package com.lap.scp.erp.core;

import java.util.List;

import com.lap.scd.commons.core.exception.ManagerException;
import com.lap.scd.commons.page.Page;
import com.lap.scp.erp.domain.ContractDO;
import com.lap.scp.erp.query.ContractQueryVO;

/**
 * <pre>
 *  合同信息 业务操作对象，保持事务一致，尽量在这里减少操作时间，
 *  比如：初始化数据（除非跟数据库交互），尽量不要在该层操作，
 *  不然会拉长事务的时间，加大对数据库的锁（不一定是行锁、全数据锁）时间。
 *
 *  控制层统一命名规则：
 *  增加保存 	insertXX,
 *  修改保存 	updateXX,
 *  查询分页 	queryPage,
 *  根据ID查询 	queryById,
 *  删除 		deleteById
 *
 * </pre>
 * 
 * @author 劳水生 Exp
 * @Date 2018-9-30 20:11:44
 * @since 2.0.0
 */
public interface ContractManager {
	/**
	 * <pre>
	 * 新增 合同信息
	 * </pre>
	 *
	 * @param contractDO
	 * @throws ManagerException
	 */
	void insertContract(ContractDO contractDO) throws ManagerException;

	/**
	 * <pre>
	 * 根据ID删除 合同信息
	 * </pre>
	 *
	 * @param contractId
	 * @return 更改数量
	 * @throws ManagerException
	 */
	int deleteById(Integer contractId) throws ManagerException;

	/**
	 * <pre>
	 * 分页查询合同信息
	 * </pre>
	 *
	 * @param page
	 * @param queryVO
	 * @return 数据集合
	 * @throws ManagerException
	 */
	List<ContractDO> queryPage(Page page, ContractQueryVO queryVO) throws ManagerException;

	/**
	 * <pre>
	 * 根据ID查询合同信息
	 * </pre>
	 *
	 * @param contractId
	 * @return ContractDO
	 * @throws ManagerException
	 */
	ContractDO queryById(Integer contractId) throws ManagerException;

	/**
	 * <pre>
	 * 根据ID查询合同信息
	 * </pre>
	 *
	 * @param contractId
	 * @return ContractDO
	 * @throws ManagerException
	 */
	ContractDO queryReceiById(Integer contractId) throws ManagerException;

	/**
	 * <pre>
	 * 根据ID和分类查询，支付信息
	 * </pre>
	 *
	 * @param contractId
	 * @param type
	 * @return ContractDO
	 * @throws ManagerException
	 */
	ContractDO queryDetailById(Integer contractId, Integer type) throws ManagerException;

	/**
	 * <pre>
	 * 根据客户ID统计该客户的所有合同金额，已付金额
	 * </pre>
	 *
	 * @param customerId
	 * @return ContractDO
	 * @throws ManagerException
	 */
	ContractDO queryStatisByCustomerId(Integer customerId) throws ManagerException;

	/**
	 * <pre>
	 * 根据ID修改合同信息
	 * </pre>
	 *
	 * @param contractDO
	 * @return 修改变更的数量
	 * @throws ManagerException
	 */
	int updateContract(ContractDO contractDO) throws ManagerException;

	/**
	 * <pre>
	 * 查询默认2000条有效合同记录
	 * </pre>
	 * 
	 * @return
	 * @throws ManagerException
	 */
	List<ContractDO> queryList() throws ManagerException;

}
